---
title: dcmi_get_device_flash_info_v2接口原型
description: "int dcmi_get_device_flash_info_v2(int card_id, int device_id, unsigned int flash_index, struct dcmi_flash_info *flash_info)"
url: https://www.hiascend.com/document/detail/zh/Atlas%20200I%20A2/latest/re/api/api_032.html
sourcePath: /source/zh/Atlas 200I A2/260RC1/re/api/api_032.html
indexId: 59388ea86764c9309590a58db50ccbf35686abc8f6216adc7e193ed81e75027d51
---
# dcmi_get_device_flash_info_v2接口原型

#### 函数原型

int dcmi_get_device_flash_info_v2(int card_id, int device_id, unsigned int flash_index, struct dcmi_flash_info *flash_info)


#### 功能说明

获取设备内Flash的信息。


#### 参数说明

| 参数名称 | 输入/输出 | 类型 | 描述 |
| --- | --- | --- | --- |
| card\_id | 输入 | int | 设备ID，当前实际支持的ID通过dcmi\_get\_card\_list接口获取。 |
| device\_id | 输入 | int | 芯片ID，通过dcmi\_get\_device\_id\_in\_card接口获取。取值范围如下： NPU芯片：[0, device\_id\_max\-1]。 |
| flash\_index | 输入 | unsigned int | Flash索引号，通过dcmi\_get\_device\_flash\_count获取。取值范围：[0, flash\_count\-1] |
| flash\_info | 输出 | struct dcmi\_flash\_info \* | 返回Flash信息。 Flash信息结构体定义： struct dcmi\_flash\_info { unsigned long long flash\_id; //Flash ID unsigned short device\_id; //设备ID unsigned short vendor; //厂商ID unsigned int state; //Flash health, 0x8表示正常，0x10表示异常 unsigned long long size; //Flash大小，单位Byte unsigned int sector\_count; //擦除单元数量 unsigned short manufacturer\_id; //制造商ID }; |


#### 返回值说明

| 类型 | 描述 |
| --- | --- |
| int | 处理结果： 成功：返回0。 失败：返回码请参见返回码。 |


#### 异常处理

无。


#### 约束说明


**表1 不同部署场景下的支持情况**

| 物理机场景（裸机） | 物理机场景（裸机） | 物理机+普通容器场景 |
| --- | --- | --- |
| root用户 | 运行用户组（非root用户） | root用户 |
| Y | Y | Y |
| 注：Y表示支持；N表示不支持；NA表示不涉及，当前未规划此场景。 | 注：Y表示支持；N表示不支持；NA表示不涉及，当前未规划此场景。 | 注：Y表示支持；N表示不支持；NA表示不涉及，当前未规划此场景。 |


#### 调用示例

```
…
int ret = 0;
int card_id = 0x3;
int device_id = 0;
struct dcmi_flash_info flash_info = {0};
unsigned int flash_count = 0;
ret = dcmi_get_device_flash_count(card_id, device_id, &flash_count);
if (ret != 0){
//todo：记录日志
return ret;
}
for (unsigned int i = 0; i < flash_count; i++){
ret = dcmi_get_device_flash_info_v2(card_id, device_id, i, &flash_info);
if(ret != 0){
//todo：记录日志
return ret;
}
}
…
```
